home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / ASTRNOMY / STARPL20.ZIP / STARPLOT.DOC < prev    next >
Text File  |  1993-10-10  |  32KB  |  881 lines

  1. STARPLOT VERSION 2.0                    BY BERNARD CZENKUSZ
  2.  
  3.  
  4.  
  5. This document contains information on the STARPLOT program. 
  6.  
  7. STARPLOT may be freely copied and given away.  A minimal handling 
  8. and media charge is permitted.  As many ".STR" files should be 
  9. passed with STARPLOT as possible since the program isn't much good 
  10. without them.
  11.  
  12. If you find this program useful then an eight pounds registration 
  13. fee is requested, please see the end of this document for details.
  14.  
  15.  
  16.  
  17. INTRODUCTION
  18.  
  19. The program is a cross between a plotting program and a star 
  20. chart. It is intended for the production of custom designed finder 
  21. charts, with symbols, text, lines and labels.
  22.  
  23. Items are plotted using Right Ascension and Declination 
  24. coordinates against a spherical projection background which can be 
  25. moved and zoomed to give a view of the celestial sphere in any 
  26. direction. 
  27.  
  28. Like a plotting program, a chart, once drawn, can be saved to a file.
  29. Thus star charts, at different levels of detail or magnitude, can 
  30. be produced, covering any area of the sky.
  31.  
  32. Star charts can be created by either loading in from previously 
  33. made star charts, or by accessing the Hubble Guide Star Catalogue 
  34. on CD disks.
  35.  
  36.  
  37. SYSTEM REQUIREMENTS
  38.  
  39. STARPLOT requires EGA or VGA capability, sorry CGA wont work.
  40.  
  41. STARPLOT V2.0 needs a hard disk as it swops parts of itself to 
  42. disk (or expanded memory) to save RAM space.
  43.  
  44. The *.STR files contain star charts which can be loaded into 
  45. STARPLOT as required.  These could be held on your hard disc or 
  46. you may want to keep them on separate floppies to avoid cluttering 
  47. up your hard disk.
  48.  
  49. STARPLOT can work with a mouse, and can print charts to an EPSON 
  50. compatible printer.
  51.  
  52. If you want to use the Hubble Guide Star Catalogue, you will need 
  53. a CD-ROM and the two CD's containing the catalogue.  Astronomical 
  54. magazines usually carry advertisements for software suppliers who 
  55. can provide these.  They are NOT included as part of the 
  56. registration fee!  (Come-on, its only eight pounds!)
  57.  
  58.  
  59. STARTUP 
  60.  
  61. You should have, in one directory, at least the following files;
  62.  
  63.       STARPLOT.EXE  -  The main program. 
  64.  
  65.       STARPLOT.CFG  -  Holds configurations, such as colour. 
  66.  
  67.       STARPLOT.DOC  -  This file. 
  68.  
  69. You should also have a number of starchart files such as 
  70. BRIGHT4.STR which contains all stars to magnitude 4, or ORI.STR 
  71. which contains the constellation of Orion to magnitude 6.
  72.  
  73. There may also be *.SYM files which hold alternative symbol 
  74. definitions, these can be created using STARPLOT.
  75.  
  76. You may start the program by typing either STARPLOT or 
  77. STARPLOT NAME.STR  where NAME.STR is any star chart file name, 
  78. this automatically loads in NAME.STR saving you the trouble of 
  79. going through menu options to load in the file you want. 
  80.  
  81. Wherever you are in the program, try pressing the ? key to display 
  82. context sensitive help. 
  83.  
  84. If you are using STARPLOT for the first time, and you have a CD-
  85. ROM, go to the FILE-OPTIONS menu, and set the CD-ROM drive letter, 
  86. then choose Save to store that information.  From then on STARPLOT 
  87. will know which drive to go to for the Hubble GSC.
  88.  
  89. There are two modes - CHART MODE, and CONTROL MODE.
  90.  
  91.  
  92.  
  93. CHART MODE
  94.  
  95. The chart is displayed and a number of commands are available to 
  96. manipulate it.  These commands are listed on the left of the 
  97. screen, ? displays them more fully.
  98.  
  99. The commands include moving and zooming the chart, and adding or 
  100. deleting items.  Certain other functions such as file loading and 
  101. saving, printing, and tabular data input are available by 
  102. pressing the Esc key and entering Control Mode.
  103.  
  104.  
  105.  
  106. CONTROL MODE
  107.  
  108. This consists of a series of nested menus, each menu option only 
  109. needing its initial letter to be typed to activate.  If a mouse is 
  110. used, point the mouse arrow at an option and click the left mouse 
  111. key.
  112.  
  113. Pressing the Esc key (or clicking the right mouse key) returns 
  114. back through the menu's.
  115.  
  116. If you are using STARPLOT for the first time you will need to go 
  117. through the menu's to load a file.  The *.STR files in the current 
  118. directory will be displayed, load one and then repeatedly Esc back 
  119. to Chart mode to play with it.
  120.  
  121. The top menu has the Q to Quit STARPLOT option.  At any time press 
  122. ? for help.
  123.  
  124.  
  125.  
  126. MOUSE OPERATION
  127.  
  128. Please note: There may be some systems where the mouse does not 
  129. work correctly - if you find this, then there is an option in the 
  130. program to disable the mouse and work with cursor keys only. 
  131. (Under the FILES, OPTIONS menu).
  132.  
  133. In general the left mouse key acts like the Enter key, and the 
  134. right mouse key acts like the Esc key.
  135.  
  136. Pointing the mouse arrow at a menu option, or a data input box, 
  137. and clicking the left key chooses the option, or activates the 
  138. input box so data can be typed in.
  139.  
  140. In chart mode, clicking the left mouse key changes the chart 
  141. cursor to a mouse arrow - which can be used to point to one of 
  142. the options, though it may be just as easy to type the option 
  143. letter from the keyboard.
  144.  
  145.  
  146.  
  147. PLOTTED ITEMS - SYMBOLS, OBJECTS, LABELS, TEXT, CURVES
  148.  
  149. The above items are summarised here, and are dealt with in greater 
  150. detail later.
  151.  
  152. A hundred different SYMBOLS are available, which you can use.
  153.  
  154. An OBJECT is an item such as a star, and consists of a symbol 
  155. plotted at a point specified by its Right Ascension and 
  156. Declination coordinates.
  157.  
  158. A LABEL is a symbol such as a Greek letter.
  159.  
  160. TEXT is a short text string.
  161.  
  162. A CURVE is a series of up to ten points, plotted by RA and DEC 
  163. coordinates, joined together by either a smooth curve, by straight 
  164. lines or by dotted lines.  As a special case; if only two points 
  165. are used they can define a circle.
  166.  
  167.  
  168.  
  169. SYMBOLS
  170.  
  171. If the file STARS.SYM is present, it is automatically loaded on 
  172. program startup, it contains 100 different symbols, which are used 
  173. to plot stars, or Greek letters, or any other symbol you want.  If
  174. STARS.SYM is not present, STARPLOT generates a default set of 
  175. symbols which should normally be sufficient for all your needs.
  176.  
  177. You are given the capability to individually edit, and redefine any
  178. of the symbols.  You may then, if you wish, save the altered set 
  179. to a file such as MYSTARS.SYM.  If you call it STARS.SYM it will 
  180. automatically be loaded on program startup.  You may also load a 
  181. *.SYM file at any time.
  182.  
  183. If you want to generate the default set, simply start STARPLOT 
  184. without a STARS.SYM file. 
  185.  
  186. Please note that Symbol 0 has special significance.  It is the null
  187. symbol, normally left as a blank.  Any star too faint for a particular
  188. level of zoom is plotted as symbol 0.
  189.  
  190.  
  191.  
  192. OBJECTS
  193.  
  194. Each object such as a star is stored with the following 
  195. information:
  196.  
  197. A 31 character name field; this can store any text you want. If 
  198. the object is a planet, this field should have name and date, see 
  199. Planet File Merge later in this document.
  200.  
  201. Magnitude.
  202.  
  203. RA and DEC coordinates; used by STARPLOT to plot the stars 
  204. position from a geocentric point of view.
  205.  
  206. Five Zoom and Symbol fields; the zoom levels are arranged in 
  207. ascending order, each with an appropriate symbol.  As the user 
  208. increases the screen zoom, the star is displayed with the symbol 
  209. for that zoom level.  Thus the stars can appear to get brighter 
  210. with zoom, by changing symbol.
  211.  
  212. If the smallest zoom value is greater than 1, say 8, then for zoom
  213. levels 1 to 7 a blank symbol is plotted (symbol 0).
  214.  
  215.  
  216.  
  217. LABELS
  218.  
  219. If a label, such as the Greek letter alpha, was simply plotted at 
  220. an RA/DEC point adjacent to a star, then the following difficulty 
  221. would arise.
  222.  
  223. As you zoomed in to the star, the distance between the stars 
  224. coordinates and the labels coordinate would be magnified, and the 
  225. label would seem to move away from the star, perhaps even right 
  226. off the screen!
  227.  
  228. To avoid this, the label is tagged to the star, a screen offset is 
  229. chosen, say ten pixels to the right, and then the label is 
  230. plotted.  At any magnification, the label will now always be 
  231. plotted at ten pixels to the right of the star.
  232.  
  233. Thus a label is stored with the RA/DEC coords of the tagged 
  234. object, and the offset.  Two zoom values are also stored.  If 
  235. these are 3 to 5 for example, then the label will only be 
  236. displayed between zoom values 3 to 5.  Thus labels can appear and 
  237. disappear with changing zoom.
  238.  
  239. If it is required to plot a label at a point without tagging to an 
  240. object, then temporarily make an object, put in the label, and 
  241. delete the object.
  242.  
  243.  
  244.  
  245. TEXT
  246.  
  247. Text is exactly the same as a label, except where a label is 
  248. taken from the symbol file, a short text string can be typed in.
  249.  
  250.  
  251.  
  252. CURVES
  253.  
  254. A curve consists of a set of points joined together by lines.  
  255. These lines can be straight Lines, Dotted lines, or a smooth 
  256. Curve can be drawn through the points.  Any curve can have its 
  257. type changed by simply 'Inspecting' it and changing the value in 
  258. the 'Type' field to either 'L', 'D' or 'C'.
  259.  
  260. Curves, (and text and labels) can be switched off, so none are 
  261. displayed, or they can be individually set to be only displayed 
  262. over a range of zoom values.
  263.  
  264. A curve will only appear if all the points of the curve are on 
  265. screen together.
  266.  
  267. A smooth curve of two points is no different to a straight line of 
  268. two points, therefore the program makes an exception in this case.  
  269. If only two points are plotted, and 'C' for smooth curve is 
  270. chosen, then instead of a line between the two points, a circle 
  271. is drawn, with the first point being at the centre, and the second 
  272. point being on the circumference.
  273.  
  274.  
  275.  
  276. CHART MODE COMMANDS
  277.  
  278.  
  279. Always remember the ? key gives context sensitive help.
  280.  
  281. ADD - Having pressed 'A' to add an object, move the cursor to the 
  282. position required and press Enter.  You will be prompted for a 
  283. name and a symbol, which will then be displayed at this position.
  284.  
  285. DELETE - 'D' deletes the item nearest the cursor.
  286.  
  287. TEXT - Having pressed 'T' you will be given a further option of 
  288. inputting a text string or a label, or switching the display of 
  289. text and labels on or off.
  290.  
  291. CURVES - Pressing 'C' gives you the option of inputting a smooth 
  292. curve, a circle, a series of straight lines or dotted lines.  You 
  293. can also choose to switch off or on the display of curves.
  294.  
  295. INSPECT - Move the cursor near to an item and press I for Inspect.  
  296. A form will be presented for that item, with symbol, zoom values 
  297. etc..
  298.  
  299. If one item, such as a curve, lies on top of an object, then the 
  300. item inspected will be the curve.  To inspect the object, use the 
  301. C for Curve command, then switch off curves.  Now only objects 
  302. will be displayed, and can be inspected.
  303.  
  304. The same forms can be accessed via the menu's in control mode, 
  305. with the added feature of scrolling through each item.  This is 
  306. particularly useful if you are inputting items from tabular data, 
  307. you do not need to use the chart modes add function.
  308.  
  309. GRID - 'G' toggles on and off a grid of RA and DEC lines, their 
  310. spacing depends on the level of zoom you are currently at.
  311.  
  312. ECLIPTIC - 'E' displays an ecliptic line.
  313.  
  314. ZOOM - On pressing 'Z' you will be prompted for a zoom value of 1 
  315. to 9999.  1 corresponds to minimum magnification, 9999 is maximum.
  316.  
  317. Pressing the Page Up or Page Down keys does a zoom up or down 
  318. without the need to type in a value.
  319.  
  320. JUMP - The jump function allows you to jump the cursor onto an 
  321. object such as a star.  This is useful when zooming onto a star.
  322.  
  323. If, for example, you just put your cursor near to a star, and then 
  324. put in a large zoom value, the star may disappear off the screen 
  325. since the distance between the star and the cursor point is 
  326. magnified.  By first 'Jumping' onto the star you can be certain 
  327. that the cursor is precisely positioned on the stars coordinates.
  328.  
  329. Jump is also useful when drawing lines between stars.  You want to 
  330. be sure a line goes to a star, and not just near it.
  331.  
  332. MOVE - To move about the sky press M.  The cursor now has a 
  333. "rubber band" to the screens centre.  Every time the Enter key is 
  334. pressed (or left mouse key).  The screen is repositioned with what 
  335. was under the cursor, now being at the screen centre.
  336.  
  337. Pressing Esc ends the move operation.
  338.  
  339. HORIZONTAL/VERTICAL INVERSIONS - Pressing H flips the screen 
  340. horizontally, V vertically.
  341.  
  342. Pressing V and then H has the combined effect of turning the 
  343. screen upside down.  So this program is useful for both North and 
  344. Southern hemispheres.  When a chart is saved, the current state of 
  345. inversion is saved with it.  So if you want BRIGHT4.STR to be the 
  346. other way up, simply load it, flip it using H and V.  Then resave 
  347. it.
  348.  
  349. Only positions are flipped, text and symbols still remain the 
  350. right way up, so you don't have to stand on your head, or read 
  351. them through a mirror.
  352.  
  353.  
  354. +/-  The + and - keys can be repeatedly pressed to increase or 
  355. decrease the cursors movements under arrow key or mouse control.  
  356. It is sometimes useful, when doing detailed work to have very tiny 
  357. cursor movements, just repeatedly press the - key to achieve this.
  358.  
  359.  
  360.  
  361. CONTROL MODE MENUS
  362.  
  363. Pressing Esc in Chart mode will give the Control Mode menu.  This 
  364. in turn gives you more options.
  365.  
  366. A File menu for loading, saving and merging .STR files.
  367.  
  368. A Symbol menu for designing your own symbols.
  369.  
  370. A Print menu for initiating a chart print.
  371.  
  372. A Data menu for inputting or editing tabular data.
  373.  
  374. Access to the Hubble Guide Star Catalogue.
  375.  
  376.  
  377.  
  378. HUBBLE GUIDE STAR CATALOGUE
  379.  
  380. To load data from the GSC; first in Chart mode, move and zoom the 
  381. screen to the area of the sky you are interested in, then press 
  382. Esc for the Control Mode menu, and choose 'H'.
  383.  
  384. You will be instructed to insert one of the CD's in your CD-ROM 
  385. drive, do so and then press Enter.
  386.  
  387. STARPLOT will then search through the GSC for stars within the 
  388. area of the screen display.  If you have chosen a low zoom level, 
  389. with a corresponding large area this search can take a very long 
  390. time.  With a zoom of about 100 and greater the search will be 
  391. much shorter.
  392.  
  393. The search will look for the brightest stars in the area you have 
  394. defined, STARPLOT will pick a limiting magnitude level designed to 
  395. load in approximately 1000 stars.  So for a large area you will 
  396. get 1000 stars, and then if you zoom in to a smaller area, and do 
  397. another search you will again get a 1000 stars.  This should 
  398. always therefore give you the required detail.
  399.  
  400. During the search a progress graph will be displayed, and the 
  401. number of regions to be scanned will be shown.  Regions are the 
  402. areas into which the GSC is organised. If necessary, part way 
  403. through the search you will be asked to change the CD, so the 
  404. other half of the sky can be scanned.
  405.  
  406. Once done, the data will be shown on screen and can be manipulated 
  407. and edited as normal.
  408.  
  409.  
  410. TABULAR DATA
  411.  
  412. You may wish to input an object such as a comet from tabular data, 
  413. the best way to do this is to start from a blank screen, you can 
  414. always MERGE the file onto a background of stars later.
  415.  
  416. Enter control mode, and choose the DATA option.
  417.  
  418. The Data menu has a decimal mode option, if your data is in the 
  419. format of hours, minutes and seconds, choose decimal seconds, 
  420. however if your data is just in hours and minutes, then choose 
  421. decimal minutes mode.
  422.  
  423. Then choose O for Objects, and Insert an object.  As you fill in 
  424. the data boxes please note;  Enter, Tab or Down arrow will move 
  425. you forward, Up arrow or SHIFT and TAB pressed together will move 
  426. you back a field, Esc will move you directly to the "Data 
  427. Correct?" box.
  428.  
  429. At the "Data Correct?" box, a y for yes will accept the data, an n 
  430. for no will restart at the first field to allow you to change the 
  431. data, and a further Esc will abandon the operation and lose your 
  432. inputs.
  433.  
  434. If you use a mouse, pointing and clicking at any field activates 
  435. that field for input.
  436.  
  437. There are fields for object name, magnitude and coordinates, plus 
  438. five zoom and symbol fields.
  439.  
  440. The Zoom levels and associated Symbols field contains the symbol 
  441. which will be shown at each zoom level and above.  For example;
  442.  
  443.     Zoom  4     Symbol  2
  444.           7            13
  445.          10            52
  446.           0             0
  447.           0             0
  448.  
  449. When the chart is zoomed the following display for this object 
  450. will be seen;
  451.  
  452. At zooms 1 to 3 the symbol 0 is plotted which is usually the blank 
  453. symbol, ie nothing is seen, presumably the object is too faint.
  454.  
  455. At zooms 4 to 6 the symbol 2 is plotted - not the numeral 2 but  
  456. symbol number two from the symbol set - as shown on the form.
  457.  
  458. At zooms 7 to 9 symbol 13 is plotted.
  459.  
  460. At zooms 10 to 9999 symbol 52 is plotted - the values with zoom 
  461. 0 being ignored.
  462.  
  463. If all the zoom and symbol values are zero, then on typing a 
  464. magnitude value, STARPLOT will put in suggested zoom levels and 
  465. symbols for you.  You may then overwrite them if you wish.
  466.  
  467. Having filled in the data for all the objects, go to the FILES 
  468. menu and the File Information option.  There are five lines of 
  469. text which will be saved with the file.  They are for your use and 
  470. should contain information such as credits and epoch of the data.  
  471. Then save the file to a suitable NAME.STR file.
  472.  
  473. The Data menu also has the "Shrink file" option.  This deletes all 
  474. off screen items.
  475.  
  476. For example; assuming you have made a finder chart, by loading 
  477. bright5.str, all stars to magnitude 5, and you have moved to the 
  478. point of interest and have there added further detail.  You will 
  479. now want to save your chart.
  480.  
  481. Saving the whole file will however also save the entire contents 
  482. of bright5.str, which is of no use to you.  Shrinking the file 
  483. will only leave the data currently shown on screen, which can then 
  484. be saved.
  485.  
  486. The shrink option will delete anything not currently shown, if 
  487. text and curves are switched off, they will be deleted.
  488.  
  489. At low levels of zoom fainter stars are plotted as symbol 0 
  490. objects and are not shown, if you do not want the shrink file 
  491. option to delete these, temporarily redefine symbol zero as a 
  492. star, so all the too faint objects are shown.
  493.  
  494. Also under the Data menu is a "Make text file" option, this is 
  495. described below.
  496.  
  497.  
  498. FILES
  499.  
  500. STARPLOT can create a number of different files.
  501.  
  502. The .STR files that hold the chart information.
  503.  
  504. The .SYM files that hold sets of one hundred symbols.
  505.  
  506. The STARPLOT.CFG file that holds options such as screen colour.
  507.  
  508. TEXT files which list all the objects, their RA and Declination 
  509. coordinates and magnitudes, in a columned ASCII format which is 
  510. both human and machine readable.  This option is available under 
  511. the Data menu.  The coordinates can be listed in either decimal 
  512. minutes or decimal seconds mode depending on the format specified 
  513. in the data menu.
  514.  
  515. PLOT TEXT FILES hold a list of the items on the screen with their 
  516. screen pixel coordinates and symbol numbers, in an ascii text 
  517. format.  These are intended for anyone who wishes to write a 
  518. routine to create the chart on some other device such as a 
  519. plotter.  The option "Save plot text file" is available in the 
  520. Print menu.
  521.  
  522. .PCX files, also available in the Print menu.  This option saves 
  523. the chart image to disk in the widely used .PCX format.  The chart 
  524. can then be imported into a great many paint and desktop 
  525. publishing programs, with all the facilities for editing and 
  526. printing that they offer.
  527.  
  528. A routine has been written "SHOW.EXE" which you may also have on 
  529. disc (if you don't have it, it can be sent to you when you 
  530. register STARPLOT), this program takes a number of the plot text 
  531. files and displays them on screen sequentially, in effect making a 
  532. slide show.
  533.  
  534.  
  535. LOADING A FILE
  536.  
  537. When loading a file, a list of files is displayed, through which 
  538. you can scroll, and choose one.
  539.  
  540. The files displayed are defined by a "Find" string, so if the find 
  541. string is *.str, all the files ending with the .str extension, and 
  542. in the same directory as the STARPLOT program, will be displayed.
  543.  
  544. You may type in your own find string.  For example, if STARPLOT is 
  545. in a directory called STARPLOT, and you keep your starcharts in a 
  546. subdirectory beneath STARPLOT called STRS, then a find string of 
  547. STRS\*.STR will list your starcharts.
  548.  
  549. To save you the effort of typing in the find string whenever you 
  550. run the program, you may save it to STARPLOT.CFG which is loaded 
  551. on program startup and sets all the defaults.  To save 
  552. STARPLOT.CFG go to the File menu, choose Options, and then choose 
  553. Save.
  554.  
  555. In fact four Find strings will be saved, one for loading a 
  556. starchart file, one for loading a symbol file, and one each for 
  557. the merge and planet merge functions which are described below.  
  558. This allows you to keep symbol files, starcharts, and planet files 
  559. in different subdirectories if required.
  560.  
  561. Be aware that if you receive a copy of STARPLOT from a friend, the 
  562. find strings may be set to his or her directory structure.  It 
  563. would be helpful, if passing STARPLOT on, to make sure the Find 
  564. strings are all of the simple *.STR and *.SYM type.  Simply 
  565. deleting the file STARPLOT.CFG will in any case set all these 
  566. values to defaults.
  567.  
  568. In the File Menu there are two important functions, File Merge, 
  569. and Planet File Merge, these are described below.
  570.  
  571.  
  572.  
  573. FILE MERGE
  574.  
  575. It is possible to merge files, up to the maximum program limits.
  576.  
  577. This is done by loading one file as usual, and then Merging 
  578. another file into the current one, effectively adding the two 
  579. files together. 
  580.  
  581. If a comet or planets path is input on to a blank screen from 
  582. published tables, then MERGE can be used to merge in a file 
  583. containing the background stars.
  584.  
  585. Another use is to merge two constellation charts to produce a 
  586. larger composite chart containing both constellations.
  587.  
  588. It may take an appreciable length of time to merge two large .STR 
  589. files, since the merge function compares every object in one file 
  590. with every object in another in an attempt to avoid duplications.
  591.  
  592.  
  593.  
  594. PLANET FILE MERGE
  595.  
  596. Whereas FILE MERGE just adds two files together, PLANET FILE MERGE 
  597. accesses a disc file and extracts the positions of planets for a 
  598. specified day, and adds these positions to the current file.
  599.  
  600. To enable this, there must be date information for each object in 
  601. the file, this is held in the object name field, for example;
  602.  
  603.              "Saturn  10 Oct 1992"
  604.  
  605. Usually planet information for a year is held in separate files, 
  606. PLAN1992.STR, or PLAN1993.STR for instance.
  607.  
  608. The function is not restricted to planets, any object with a 
  609. date in the name field can be extracted, comets or minor planets 
  610. for example.
  611.  
  612. The detailed action of the function is as follows:
  613.  
  614. 1.  Prompts the user for a required date.
  615.  
  616. 2.  Prompts the user for a file name - such as PLAN1992.STR
  617.  
  618. 3.  Searches through the file for objects with a date in their 
  619. name field.
  620.  
  621. 4.  Sorts the objects found by name, it gathers all the Saturn's 
  622. Venus's, Mercury's etc., together.  Ten different bodies can be 
  623. handled, each with multiple entries for different dates.
  624.  
  625. 5.  For each body, if the required date is present, it is added to 
  626. the current file.
  627.  
  628. 6.  If there is no entry for the body at the required date, then 
  629. the function picks out three entries for that body closest in time 
  630. to the required date.  It uses these to interpolate the position 
  631. and magnitude of the body at the required date, and adds this 
  632. made-up entry to the current file.  (There must be at least three 
  633. entries available in the required year to do this).
  634.  
  635. That's it.  You end up with the planets plotted on your chart at 
  636. their correct positions for the date you specified.
  637.  
  638. If you wish your own files to work with this function, then you 
  639. must add the date to your object names.  For example if you are 
  640. creating a file containing data for Vesta through 1995 called
  641. VEST1995.STR, for each entry you must obey the following name 
  642. format:
  643.  
  644.                "Vesta  dd mmm yyyy"
  645.  
  646. Where dd is the day of the month, mmm is a three character month 
  647. designation, such as Jan or Jul, (July is not acceptable, it must 
  648. be only three characters) and yyyy is the four digit year number.
  649.  
  650. Stick to a single spelling of Vesta otherwise the function 
  651. will think you have data for two different bodies!
  652.  
  653. The files PLAN1992.STR, PLAN1993.STR etc., could be made by typing 
  654. in planet positions from an almanac.  However there is available a 
  655. program MAKEPLAN.EXE which generates them.  This will be sent to 
  656. you if you register STARPLOT.
  657.  
  658. MAKEPLAN V1.3 can also create files of comet and minor planet 
  659. positions from their orbitel elements.  These files could be 
  660. loaded or merged to show all positions, delineating the bodies 
  661. path through the sky, or Planet File Merge could be used to pick 
  662. out the bodies position on a single day.
  663.  
  664.  
  665. FILE.STR FORMAT
  666.  
  667. There are available, from various sources, ASCII files of star 
  668. catalogues.  These files are usually made up of records, each 
  669. record being a line of text with, amongst other items of info, an 
  670. objects Right Ascension and Declination coordinates.
  671.  
  672. A program has been written, COMPSTR, which on being told the 
  673. catalogues structure, can convert it to .STR format, assuming the 
  674. catalogue is well behaved, the records being of constant length, 
  675. and the coordinate fields at set byte positions.
  676.  
  677. The "Make Text File" option in the Data menu creates such a file, 
  678. so COMPSTR could be used to convert it back to .STR format.
  679.  
  680. For anyone interested in writing their own programs that 
  681. generate files which can be used with STARPLOT the format of a 
  682. .STR file is made of the C arrays and structures listed below.
  683.  
  684. If you don't program in C, then there is another routine available 
  685. "CONVERT.EXE", which converts an ascii text format, easily 
  686. produced using GWBASIC's WRITE# command, to the .STR format 
  687. described here. Both CONVERT.EXE and COMPSTR.EXE can be sent to 
  688. you if you register STARPLOT.
  689.  
  690. Please note, all RA and DEC coords are held as 'double' variables, 
  691. these are of 64 bits, (floating point to 15 digit precision) and 
  692. contain the coordinate in minutes: Thus RA of 1 hour 5 minutes and 
  693. 30 seconds will be held as 65.5,  and DEC of -10 degrees 7 
  694. arcminutes and 15 seconds will be held as -607.25. 
  695.  
  696.  
  697. char header[32] = "STARPLOT V1.0 STR              ";
  698.  
  699. /* The header string must contain the above Null terminated */
  700. /* string exactly, please note the V1.0 - not V2.0, this is */
  701. /* because version 2.0 of STARPLOT did not change the file  */
  702. /* structure in any way */ 
  703.  
  704. char comments[5][32];
  705.  
  706. /* comments hold the users text comments about his file */
  707. /* Five Null terminated strings */
  708.  
  709. int objects;
  710.            
  711. /* 16 bit integer, max value 2000 */
  712. /* contains the number of objects */
  713. /* Note; an object is not a text,label or curve */
  714.  
  715. /* This value is followed by the following structure */
  716. /* repeated for every object in the file, ie "objects" times */
  717.  
  718. struct {
  719.          char objectname[32];
  720.          float magnitude;     /* 32 bit floating point number */
  721.          double objectra;
  722.          double objectdec;
  723.          int zoomsymbol[2][5];   /* zoom values, symbol values */
  724.        }
  725.  
  726.                  
  727. /* Then - */
  728.  
  729. int texts;
  730.  
  731. /* 16 bit integer, max value 200 */
  732. /* contains the number of text strings */
  733. /* followed by the following structure repeated for every */
  734. /* string, ie "texts" times */
  735.  
  736. struct {
  737.          char textstring[21];
  738.          double textra;
  739.          double textdec;
  740.          int textzoomon;  /* zoom value at which text turns on */
  741.          int textzoomoff; /* and at which text turns off */
  742.          int textx; /* Offset distance, in pixels, from textra */          
  743.          int texty; /* and textdec at which text is displayed */
  744.        } 
  745.  
  746. /* Note: the offset distance is textx pixels to the right */
  747. /* and texty pixels below the textra,textdec point */
  748. /* textx and texty can be negative values to indicate left */
  749. /* and above directions as well */
  750.  
  751. /* Then - */
  752.  
  753. int labels;
  754.  
  755. /* 16 bit integer, max value 200 */
  756. /* contains the number of labels */
  757. /* followed by the following structure repeated for every */
  758. /* label, ie "labels" times */
  759.           
  760. struct {
  761.          int labnumber;  /* The label to be displayed */
  762.          double labelra;       /* from the .sym file */
  763.          double labeldec;
  764.          int labelzoomon;
  765.          int labelzoomoff;
  766.          int labelx;   /* offset pixels again, see above */
  767.          int labely;
  768.        }
  769.  
  770.  
  771. /* Then - */
  772.  
  773. int curves;
  774.  
  775. /* 16 bit integer, max value 100 */
  776. /* contains the number of curves */
  777. /* followed by the following structure repeated for every */
  778. /* curve, ie "curves" times */
  779.  
  780. struct {
  781.          int curvepoints;   /* number of points, max 10 */
  782.          double curvera[10];
  783.          double curvedec[10];
  784.          int curvezoomon;
  785.          int curvezoomoff;
  786.          char curvetype; /* Either 'C','L' or 'D' */
  787.        } 
  788.  
  789. /* Even if there are only say three points in a curve */
  790. /* the full array of ten RA & DEC points are saved, the extra */
  791. /* values being ignored - I know it's wasteful, but its easy */
  792.  
  793.  
  794. /* Then - */
  795.  
  796. int zoom;
  797.  
  798. /* 16 bit integer, between 1 and 9999 */
  799. /* The current zoom value of the screen when the file was */ 
  800. /* saved */
  801.  
  802. double centrera;
  803. double centredec;
  804.  
  805. /* The current coordinates of the screen centre when the file */
  806. /* was saved */
  807.  
  808. int hinv;
  809. int vinv;
  810.  
  811. /* Two, 16 bit integers; Horizontal and Vertical Inversion */
  812. /* flags, 0 if inversion off, 1 if on, when the file */
  813. /* was saved */
  814.  
  815. And that's it.
  816.  
  817. I have been asked what is the status - copyright wise, of any 
  818. program that is written to produce STARPLOT files, or any chart 
  819. that is produced by STARPLOT.  As far as I am concerned, any chart 
  820. you produce using STARPLOT is yours, I make no claim whatsoever.
  821.   
  822. As for any program you may write that produces, or uses, STARPLOT 
  823. compatible files, I'd be interested in a copy please!  But 
  824. otherwise I again make no claim whatsoever, though if you 
  825. distribute your program with copies of STARPLOT, please keep this 
  826. DOC file with it, and point out that STARPLOT is shareware and 
  827. should be registered.
  828.  
  829. On the other hand, I accept no liability for any failures of 
  830. STARPLOT.  I think it's bug free, but who knows?
  831.  
  832.  
  833.  
  834. FUTURE DEVELOPMENTS 
  835.  
  836. I really don't know, after I've completed a version I always think 
  837. - right that's it!  I've finished. -  But then something comes 
  838. along or someone makes a suggestion which is too good not to put 
  839. in.
  840.  
  841. If you find yourself making good use of STARPLOT, please help to 
  842. pay for the sheer time put into its production by sending me an 
  843. eight pounds sterling registration fee.  Put in any comments you 
  844. may feel about the program, and what use you are making of it, 
  845. I'll find that very interesting.
  846.  
  847. On registering I'll send you a disk with the latest version of 
  848. STARPLOT, a bundle of .STR files, and the programs SHOW, CONVERT, 
  849. COMPSTR and MAKEPLAN.
  850.  
  851. MAKEPLAN produces .STR files of planetary positions, and can, on 
  852. being given orbitel elements, produce files of a minor planet or 
  853. comets positions.
  854.  
  855. (What disk size do you want, 5.25 or 3.5?) 
  856.  
  857. May I express my thanks to the compilers of all star catalogues.  
  858. The easy availability of the data is a real boon. Particular 
  859. thanks to the Space Telescope Science Institute for publishing the 
  860. GSC, 18,000,000 stars is just mind blowing!
  861.  
  862. Also thanks to Robert Harold, the coordinator of the Program and 
  863. Data Library of the BAA who has converted the SAO catalogue to 
  864. .STR format (available from the BAA), and who suggested the Hubble 
  865. Guide Star Catalogue as a good medium for STARPLOT to access. 
  866.  
  867. Very great thanks to those saintly souls who register their 
  868. software.
  869.  
  870. I hope STARPLOT is useful to you and you enjoy using it. 
  871.  
  872.                        Bernard Czenkusz
  873.                        3 Briggs Grove
  874.                        Wibsey
  875.                        Bradford
  876.                        West Yorkshire
  877.                        England        -    Third planet from the sun.
  878.                                            Sol system.
  879.  
  880.  
  881.